home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Purity / Purity #21 (1994-01-12)(Diesel)(DE)[WB].zip / Purity #21 (1994-01-12)(Diesel)(DE)[WB].adf / Doks / PurityMag.DOK < prev    next >
Text File  |  1994-01-12  |  9KB  |  284 lines
  1. Hallo lieber User, liebe Userin !!
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Also, fangen wir mal gleich an:
  5.  
  6.  
  7. I N H A L T
  8.  
  9. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10.   Einleitung................................................. 1
  11.     Was ist das PurityMag ?.................................. 1.1
  12.     Features................................................. 1.2
  13.   Getting started - Programmstart............................ 2
  14.     ToolTypes - Übergabe..................................... 2.1
  15.     Hauptmenü................................................ 2.2
  16.     Rubriken................................................. 2.3
  17.     Info-Gadget.............................................. 2.4
  18.     Quit-Gadget.............................................. 2.5
  19.     Hilfe gefällig ?......................................... 2.6
  20.     Iconify.................................................. 2.7
  21.   Abspann.................................................... 3
  22.     Planungen................................................ 3.1
  23.     History.................................................. 3.2
  24.     Grüße, Danksagungen etc.................................. 3.3
  25.  
  26. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  27.  
  28.  
  29.  
  30.  
  31. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  32.  
  33.                1 .  E I N L E I T U N G
  34.  
  35. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  36.  
  37. 1.1 Was ist das PurityMag ?
  38. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  39.   Das PurityMag wurde von mir geschrieben, weil ich es irgendwie blöd
  40.   fand, immer in verschiedene Unterverzeichnisse zu gehen, um irgend-
  41.   ein Programm zu starten oder eine Anleitung zu lesen.
  42.   Auf der Purity Nr. 4 gab es ja schon mal so eine Art "Mag", mit
  43.   Hilfe vom Selector. Da der "Program Selector" ja so etwas wie div.
  44.   HardDisk-Menüs ist, dachte ich mir, ich müßte ein "einzigartiges"
  45.   Mag schreiben !
  46.   Am Anfang hatte ich ja keine Lust dazu (ich stand noch so ziemlich
  47.   am Anfang mit der Systemprogrammierung !), doch dann habe ich mir
  48.   einen Ruck gegeben und das Mag geschrieben. Was Anfangs noch als
  49.   kleines Projekt gedacht war, wurde nach und nach zu einem "riesigen"
  50.   Programm (ca. 1100 Zeilen).
  51.   Also, das PurityMag hilft dem "Anfänger" und "Profi", sich mit der
  52.   Purity zurechtzufinden. Einfach ein Klick auf ein Gadget und schon
  53.   startet man ein Programm oder liest sich eine Anleitung durch !!
  54.  
  55.  
  56. 1.2 Features
  57. ¯¯¯¯¯¯¯¯¯¯¯¯
  58.   Das PurityMag ist seit der Version 1.55 NUR NOCH VON DER WORKBENCH
  59.   AUS STARTBAR !!
  60.   Es unterstützt ToolTypes, in denen die Config-Dateien festgelegt
  61.   werden (siehe 2.1) !
  62.   Als kleines Bonbon habe ich im Hauptmenü als Titel eine Grafik
  63.   dargestellt.
  64.   Die Iconify-Funktion, die ab OS2.0 funktioniert, installiert ein
  65.   AppIcon auf der Workbench !!
  66.   Ebenfalls ab OS2.0 werden die DisplayModes des aktuellen PublicScreens
  67.   übernommen, d.h. man kann nun auch in den Genuß der höheren Auf-
  68.   lösungen kommen !!
  69.  
  70.  
  71.  
  72. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  73.  
  74.     2 .  G E T T I N G    S T A R T E D  -  P R O G R A M M S T A R T
  75.  
  76. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  77.  
  78. 2.1 ToolTypes - Übergabe
  79. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  80.   Wie oben schon erwähnt, unterstützt das Programm ToolTypes, mit
  81.   denen die Config-Dateien etc. festgelegt werden:
  82.  
  83.   (Zu erreichen per Workbench - Menü, näheres siehe Amiga-Handbuch !!)
  84.  
  85.   In den ToolTypes können folgende Eintragungen stehen:
  86.  
  87.     FORUM_CONFIG=blabla
  88.     HSPAS_CONFIG=blabla
  89.     KICK_CONFIG=blabla
  90.     ALLG_CONFIG=blabla
  91.     ANL_CONFIG=blabla
  92.     PCQ_CONFIG=blabla
  93.     LMZ_AUFRUF=blabla
  94.     PNUMMER=PurityNr
  95.  
  96.   ERKLÄRUNG:
  97.  
  98.    Für die .._CONFIG ToolTypes stehen die jeweiligen Configdateien,
  99.    z.B. für KICK_CONFIG: =Purity 20:s/kick.conf
  100.    PurityMag sucht dann nach dieser Datei für die KickPascal-Progs.
  101.    ALLG bedeutet Allgemeines,
  102.    ANL bedeutet Anleitungen.
  103.  
  104.    LMZ_AUFRUF enthält z.B.:
  105.  
  106.      LMZ_AUFRUF=Purity 20:c/neptun Purity20:LiesMichZuerst
  107.  
  108.    Das Programm startet dann Neptun bei Klick auf das Lies...-Gadget !
  109.  
  110.    PNUMMER enthält die aktuelle Purity-Ausgabe, z.B.:
  111.      PNUMMER=20
  112.  
  113.  
  114.   ACHTUNG:
  115.  
  116.    Das PurityMag verlangt mindestens 20000 Bytes an Stack-Speicher.
  117.    Dieser muß auch in dem Information-Fenster unter "Stack:" fest-
  118.    gelegt werden !!
  119.  
  120.  
  121.   Das PurityMag übernimmt ab OS2.0 die Modes des Default Public Screens,
  122.   d.h. man kann auch die höheren Auflösungen benutzen =;)
  123.  
  124.  
  125. 2.2 Hauptmenü
  126. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  127.   Nach dem Start des Programms und dem Lesen der Configdateien er-
  128.   scheint das Hauptmenü.
  129.   Das obere Drittel nimmt das Titelbild ein. Darunter siehst Du
  130.   eine Information, mit welcher Purity Du gerade "arbeitest".
  131.   Nach dieser Info kommen die HauptGadgets für die Rubriken,
  132.   Info übers Programm etc.
  133.   Danach kommt ein Hinweis: Wenn Du die Taste <HELP> drückst, kommst
  134.   Du in das Hilfe-Menü.
  135.   Drückst die die ESC-Taste, aktivierst Du den Iconify-Modus, der
  136.   leider nur ab OS2.0 läuft (Erklärung siehe 1.2 !!).
  137.   Ganz unten siehst Du, welche Version vom PurityMag Du benutzt.
  138.  
  139.  
  140. 2.3 Rubriken
  141. ¯¯¯¯¯¯¯¯¯¯¯¯
  142.   Durch Anklicken auf eines der Rubriken-Gadgets (z.B."PCQ-P.." etc.)
  143.   kommst Du in ein neues Auswahlmenü:
  144.  
  145.   Dieses hat ganz oben einen Titel, aus dem Du ersehen kannst, in
  146.   welcher Rubrik Du gelandet bist.
  147.   Dann kommen, je nachdem, wie viele Programme zur Auswahl stehen,
  148.   verschiedene Gadgets mit verschiedenen Namen drauf. Klickst Du
  149.   eines dieser Gadgets an, schließt sich der Bildschirm und es
  150.   wird versucht, das jeweilige Programm zu starten. Sollte
  151.   irgendetwas beim Starten schief gelaufen sein, dann erscheint im
  152.   Konsolenfenster ein Meldung, daß die Ausführung nicht geklappt hat.
  153.   Nach Beenden des gestarteten Programms öffnet sich der Bildschirm
  154.   wieder.
  155.   Das letzte Gadget kann auch über die Taste "z" aktiviert werden und
  156.   bewirkt ein Zurückspringen ins Hauptmenü.
  157.  
  158.  
  159. 2.4 Info-Gadget
  160. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  161.   Bei diesem Gadget siehst Du eine kleine Info.
  162.  
  163.  
  164. 2.5. Quit-Gadget
  165. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  166.   Nach Mausklick auf dieses Gadget beendest Du das Mag.
  167.  
  168.  
  169. 2.6. Hilfe gefällig ?
  170. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  171.   Wenn Du die <HELP>-Taste drückst, erscheint ein Hilfstext, der mittels
  172.   Prop-Gadget hin- und herbewegt werden kann. Zusätzlich existieren noch
  173.   zwei Pfeil-Gadgets, mit denen Du jeweils eine bzw. mehrere (Maustaste
  174.   über dem Gadget gedrückt halten !) Zeilen vor- bzw. zurückblätterst.
  175.   Raus kommst Du übrigens mit der Taste <Q> bzw. Klick auf das oberste
  176.   Gadget.
  177.  
  178. 2.7. Iconify
  179. ¯¯¯¯¯¯¯¯¯¯¯¯
  180.   Diese Funktion ist erst ab OS2.0 verfügbar !!
  181.  
  182.   Sie wird mit der ESC-Taste im Hauptmenü aufgerufen und installiert
  183.   ein AppIcon auf der Workbench, und wartet darauf, daß ein Doppelklick
  184.   darauf geschieht. Dann gerät man wieder ins Hauptmenü.
  185.  
  186.  
  187.  
  188. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  189.  
  190.                3 .    A B S P A N N
  191.  
  192. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  193.  
  194. 3.1. Planungen
  195. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  196.   Tja, geplant habe ich folgendes:
  197.  
  198.     - Start des Mags auch auf der Workbench ODER eine Implementierung
  199.       eines ScreenMode-Requesters ab OS2.X (damit man das Mag auch
  200.       in den neuen Auflösungen starten kann !!)
  201.  
  202.     - ...
  203.  
  204.  
  205.   Wer übrigens noch weitere Ideen hat, der kann mir ja mal schreiben.
  206.  
  207.   Meine Adresse: 
  208.  
  209.     Björn Schotte
  210.     Am Burkardstuhl 45
  211.  
  212.     97267 Himmelstadt
  213.  
  214.   ZUSATZ:
  215.  
  216.    Ich arbeite kräftig an der Version 2, bei der u.a. auch volle OS2.x
  217.    Ausnützung geplant ist (OS2-Windows etc.).
  218.    OS1.x-User brauchen sich keine Sorgen zu machen, das Mag läuft auch
  219.    in Zukunft unter dem alten Betriebssystem !!
  220.  
  221.  
  222.  
  223. 3.2. History
  224. ¯¯¯¯¯¯¯¯¯¯¯¯
  225.   V1.00 - V1.5 : lange her
  226.  
  227.      B E F O R E  W R I T T E N  H I S T O R Y
  228.  
  229.   V1.55 : 13.-14.11.1993
  230.  
  231.     - Titel-Logo mit DPaint designed und per R.C.T. in ein Image kon-
  232.       vertiert.
  233.  
  234.     - Pfeil-Gadgets im HILFE-Bildschirm:
  235.  
  236.       Wenn man die Maus länger auf einem Pfeilgadget hält, wird auch
  237.       mehrmals rauf- bzw. runtergescrollt.
  238.  
  239.     - Nur noch über die Workbench startbar !
  240.  
  241.     - "Info" neuprogrammiert
  242.  
  243.   V1.6    : 15.12.-17.12.1993
  244.  
  245.     - Nachdem mir Diesel mitgeteilt hat, daß bei der KickPascal Rubrik
  246.       bei mehr als 15 Eintragungen die Spalten versetzt sind, habe ich
  247.       diesen Fehler behoben.
  248.  
  249.     - Die Anzahl der Paare in den Configs sind von 30 (V1.55) auf
  250.       40 hinaufgeschraubt worden !!
  251.  
  252.     - Iconify-Funktion hinzugefügt (nur unter ab OS2.0 !!). Installiert
  253.       ein AppIcon auf der Workbench und wartet auf Doppelklick.
  254.  
  255.     - Durch Aufsplittung meiner Tools-Unit habe ich das Mag um ca. 3-5
  256.       KB kürzer gemacht !!!
  257.  
  258.  
  259. 3.3. Grüße, Danksagungen etc.
  260. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  261.  
  262.   Grüße und Dank gehen an:
  263.  
  264.      - Røgersøft (Michael Klein) für Røgerdat und Drucky und die
  265.        tollen Border-Routinen
  266.  
  267.      - Diesel für die Idee, ToolTypes zu implementieren (hatte doch
  268.        tatsächlich Glück und traf ihn auf der WoC`93 !!) und für
  269.        die Motivation, endlich mal ein Titelbild zu designen !!
  270.  
  271.      - Perfect Soft
  272.  
  273.      - Commodore für meinen A4000/030 (wirklich sagenhaft, dieser
  274.        Computer !!)
  275.  
  276.      - und alle anderen, die ich vergessen hab !!
  277.  
  278.  
  279.   ICH HAFTE NICHT FÜR IRGENDWELCHE SCHÄDEN, DIE DURCH DAS PURITYMAG
  280.   ENTSTANDEN SIND !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  281.  
  282. ______________________________________________________________________
  283. 14.11.1993                              Björn S.
  284.